|
This page last changed on Aug 10, 2011 by rosie@atlassian.com.
|
You can easily customise JIRA's look and feel to suit your needs:
- Log in as a user with the 'JIRA Administrators' global permission.
- Select 'Administration' > 'System' > 'User Interface' > 'Look and Feel'.
Keyboard shortcut: 'g' + 'g' + start typing 'look and feel'
- The 'Look and Feel Configuration' page will be displayed as follows:
Screenshot: Look and Feel configuration (click to view larger image)

- To edit the logo, colours or time format, click the 'Edit Configuration' link at the bottom of the page. To reset to the default look and feel of JIRA, simply click the 'Reset Default' button.
Here is a list of the different configuration options available, and what they do.
|
|
Logo
The logo appears in the top left corner of every JIRA page. You can easily replace the default JIRA logo with an image of your choice.
| Option |
Explanation |
| URL |
This URL points to the absolute or relative path of the image that you wish to display at the top of the page. If the URL begins with 'http://' or 'https://' then the URL is treated as an absolute URL. Otherwise it will be treated as a relative URL, and the image will have to be packaged in the war file when you build JIRA. |
| Preview |
When an image is selected, a preview will be shown here. |
 | If the JIRA Logo isn't appearing after changing it to a custom one, ensure that the URL specified has the correct case. The value is case-sensitive. Try copying and pasting the URL into a browser and check that it appears. |
Colours
The following options control the appearance of the entire JIRA user interface.
Please note:
- The colours you specify for each of the following options can be anything that is valid for both a font tag, and a stylesheet's 'color:' attribute.
- When specifying a colour, you can use the pop-up colour chooser, or specify your own (eg. '#FFFFFF', 'red').
- To return to the original colour scheme, just clear any values that you have set.
| Option |
Explanation |
| Header Background Colour |
The background colour of the top bar (the one that includes the image). |
| Header Highlight Background Colour |
The background colour of the text that sits inside the top bar, when selected or when the mouse hovers over it. |
| Header Text Colour |
The colour of the text that sits inside the top bar (such as your user name when you are logged in). |
| Header Text Highlight Colour |
The colour of the text that sits inside the top bar, when selected or when the mouse hovers over it. |
| Header Separator Colour |
The colour of the horizontal line between the top bar and the navigation bar. |
| Navigation Bar Background Colour |
The background colour of the bar that contains the links to 'Dashboards', 'Projects', etc. |
| Navigation Bar Text Colour |
The text color of the links in the menu bar (e.g. 'Dashboards'). |
| Navigation Bar Separator Colour |
The colour of the vertical dotted line between each menu item and its drop-down symbol (triangle). |
| Link Colour |
The colour of the text links on any JIRA page. |
| Link Active Colour |
The colour of the text links on any JIRA page, when selected. |
| Heading Colour |
The colour of the text headings on any JIRA page. |
Gadget Colours
These seven colours are the seven options from which users can select when changing the colour of a gadget's frame on their JIRA dashboard. Colour 1 is the default frame colour for newly-added gadgets.
Please note:
- The colours you specify for each of the eight options can be anything that is valid for both a font tag, and a stylesheet's 'color:' attribute.
- When specifying a colour, you can use the pop-up colour chooser, or specify your own (eg. '#FFFFFF', 'red').
- To return to the original colour scheme, just clear any values that you have set.
Date/Time Formats
The 'Look and Feel' page allows you to customise the time and date formats used throughout JIRA.
When specifying dates and times, they should be based on the Java SimpleDateFormat.
When you are not in edit mode on the 'Look and Feel' page, the examples in the rightmost column of the 'Date/Time Formats' section show you how the various formats will appear in JIRA.
Configuring Date Picker Formats
To set the format of date pickers in JIRA, see Configuring Advanced Settings.
The date or date/time formats are defined by two (Java and JavaScript) properties. These two properties must match for the date (or date/time) picker to work correctly.
For Java formats, specify date/time formats based on the Java SimpleDateFormat.
For JavaScript formats, specify date/time formats based on the Unix date format.
Here are some example US-based date configurations:
| Preferred Date |
Value of the jira.date.picker.java.format property |
Value of the jira.date.picker.javascript.format property |
| Oct/1/10 |
MMM/d/yy |
%b/%e/%y |
| 10/01/10 |
MM/dd/yy |
%m/%d/%y |
| Oct 1, 2010 |
MMM d, yyyy |
%b %d, %Y |
| 10/01/2010 |
MM/dd/yyyy |
%m/%d/%Y |
Here are some examples of date/time configurations:
| Preferred Date/Time |
Value of the jira.date.time.picker.java.format property |
Value of the jira.date.time.picker.javascript.format property |
| 15/Oct/10 8:50 AM |
dd/MMM/yy h:mm a |
%e/%b/%y %I:%M %p |
| 10/15/10 08:50 AM |
MM/dd/yy hh:mm a |
%b/%e/%y %I:%M %p |
|